Command-line browsers Lynx, Links, and w3m 


SURFING THE SHELL 


—= 


If you're working at the command line and you need to reach the 


Internet, or if you just want to convert an HTML file into neatly format- 


ted ASCIl text, try a text-based web browser. BY HEIKE JURZIK 


ext-mode surfing may seem like a 
last resort, but a text-based 


browser is sometimes the perfect 
tool. In this month’s Command Line, 
you'll learn about the no-GUI browsers 
Lynx [1], Links [2], and w3m [3]. 


Lynx 

You can launch Lynx in a terminal or a 
virtual console by typing lynx - if you 
prefer, you can pass a URL or the 
address of a local HTML file to the 
browser when you launch it, e.g.: 


lynx www.]linux-magazine.com 


By default, Lynx displays an overview of 
common keyboard shortcuts at the bot- 
tom of the screen. Lynx is completely 
keyboard controlled. Table 1 shows the 
most important keyboard shortcuts. 

You can modify Lynx’s behavior by 
specifying command line options when 
you launch the browser, or by changing 
the settings in the options dialog, which 
you can call by pressing [O]. If you pre- 
fer not to be prompted to accept Cook- 
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ies, you can disable the prompt as fol- 
lows: 


lynx -accept_all_cookies 


To make this setting permanent, navi- 
gate the options dialog with the [Down 
Arrow] key until you find the entry for 
Cookies, and then press the [Right 
Arrow] key. In the menu that appears, 
you can select from ignore, ask user 
(default), and accept all (Figure 1). To 
make sure Lynx does not forget your set- 
tings when you quit the program, you 
still need to save your changes perma- 
nently (before you confirm by clicking 
on Submit or Accept Changes). To do so, 
check the Save options to disk checkbox 
by pressing the [Enter] key. Lynx stores 
user settings in a hidden configuration 
file called ~/.lynxrc, which you can 
modify using a text editor. 

You can use the -book option to tell 
Lynx to launch into a view with your 
own personal bookmarks. 

For password protected pages, either 
enter your user name and password 
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interactively, or else supply your creden- 
tials when you call the browser: 


lynx -auth=username: password? 
www.url.de 


If you use Lynx to check out local HTML 
pages, you can tell the browser not to 
follow external links when you launch 
(option -localhost). You can also use 
your favorite editor in Lynx. If you tell 
Lynx that 


lynx -editor=vim 


on launching, you can then press [E] to 
load the HTML page you are currently 
viewing in the Vim editor. After quitting 
the editor, you automatically return to 
Lynx, where you can reload the page by 
pressing [Ctrl-R]. 

To make sure Lynx remembers your 
favorite editor next time you launch the 
browser, press [O] again to access the 
option dialog, where you can enter the 
name of your favorite program in the 
Editor box. 


From Lynx to Links 

The second text browser, Links, gives 
you keyboard and mouse controls. The 
command for launching the browser is 
links - and again you can specify a URL 
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Figure 1: Using the options dialog to configure Lynx. 


or a local file. If you press [Esc] or 

click on the top line of the window with 
your mouse, Links displays a menu, 
which you can navigate using your 
mouse or keyboard. Keyboard shortcuts 
are assigned to most menu entries, and 
it makes sense to learn the shortcuts and 
leave your mouse on your mouse pad. 
Table 2 gives you an overview of the 
most common commands. As the mouse 
is used for program control, you can’t 
simply select an area of text and send it 


Want to | 


to the clipboard in the normal way - in- 
stead you have to hold down the [Shift] 
key and drag your mouse over the re- 
quired area of text. 

The Setup menu allows you to config- 
ure the browser. The Setup menu is 
where you set up things like the lan- 
guage, character set, terminal options 
(color, cursor etc.), the cache size, and 
so on. Your personal settings are stored 
in a file called links.cfg in the hidden ~/ 
.links folder. Again, links.cfg is a text- 


‘now what’ 


Figure 2: w3m gives you tabbed browsing. 


only file that you can change using your 
editor. 

Links renders tables and frames better 
than Lynx, and you can tell the browser 
how to handle specific file types. For 
example, to display PNG-formatted 
images in the external display program 
(which only runs on X Window), first 
define a file type in Setup / Associations 
/ Add. To do so, enter a name in the 
Label field, e.g., PNGs. Set the Type(s) to 
image/png, and finally, define the Pro- 
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make any changes they need. w3m pro- 
vides many configuration options, and 


[Shift--] or [H] Calls Lynx help. getting them all set to your liking will 

[Q] Quits the program after asking if you really want to quit Lynx. enhance your browsing experience. 

[Shiftt-Q] Quits Lynx without asking. 

[Up Arrow], [Down Arrow] Scroll forward or backward through links. Lots of Tricks 

He a Cl serollup as suvivone nays: Text browsers really shine in collabora- 

[Right Arrows] or [Enter] Follow a link. : : : 

Toft Arrow! Conseelenee ae other programs. If your favorite 

[K] Displays a list of available keyboard commands. editor is Vim, for example, you only 

IM] Goes back to start page. Confirm by pressing [Y]. need to add a single line to the ~/.vimrc 

[G] Opens an input dialog where you can type a new URL; configuration file to set up your favorite 

Confirm by pressing [Enter]. browser as an HTML viewer. You can 

[Shift-G] Go to last URL, allows you to modify this address. assign the browser launch function to a 

[L] Shows all visible links in the current document. key or define a new command. For 

P Printer options: Store the document in a local file, . 

ii send thee by email, send the document directly to a printer. example, youmend wade the xollowiine 

IDI Saves the file (with all images). to ~/.vimre to launch Lynx whenever 

[A] Adds a bookmark either for the page being viewed ([D]) or you press [F2]: 

for the page accessed by the link under the cursor ([L]). 

[V] Opens the bookmark manager. map <F2> :!lynx %<CR> 

[Ctrl-A] Back to top of page. 

[Ctrl-E] Go to end of page. You can replace lynx with either links or 

[Ctr R] Reload page. w3m if you prefer one of the other 

[Shift-7] (/) Start search. 

: 2 browsers. 

[Backspace] Display history. : 

[0] Open the Lynx configuration dialog. To define your own command for 
Vim, add the following to ~/.vimrc, for 


example: 


gram Links will use to display the PNG 
files. After completing these steps, use 
Add in the Setup / File extensions menu 
to define file extensions for the file type 
you have just defined. Add the possible 
file extension to Extension(s) in a 
comma-separated list, for example: 


png, PNG 


Again type image/png as the Content- 
Type, confirm by selecting OK, and save 
your changes. Now, whenever you right- 
click a PNG document that is rendered 
as an [IMG], you can select View image 
or press the [Right Arrow] key to open a 
dialog window that prompts you to 
open, save, or display (the source code) 
of the file. 


Simply w3m 

The third browser on our list is called 
w3m. In contrast to Links and Lynx, 
w3m expects you to supply a Web 
address or local path name. If you do not 
supply either, w3m simply outputs a list 
of options on your screen. 

Again, the browser supports keyboard 
and mouse controls (see Table 3 for an 
overview of keyboard shortcuts), and 
again you need to hold down the [Shift] 
key to select text passages with your 
mouse. 
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The ability to open multiple Web 
pages using the [Shift-T] shortcut, and to 
toggle between the tabs, is a really use- 
ful feature. Pressing { takes you to the 
next tab, and } takes you back. Pressing 
[Esc-T] (or [Alt-T] on some desktops) 
opens a tab selection dialog, and [Ctrl-Q] 
removes the current tab (Figure 2). 

Users of w3m definitely need to open 
the settings dialog by pressing [O] and 


command View :!lynx % 


You can then launch the browser while 
working in Vim. To launch the browser 
from Vim, press [Esc] to enter command 
mode and type : View. 

It is just as easy to integrate all three 
browsers into Mutt [4]. To view HTML 
attachments directly in your email client, 


[Esc] 


Displays and hides the menu bar. 


[Q] Quits Links - with prompt. 


[Shift-Q], [Ctrl-C] 


Quits the program without prompting. 


[Up Arrow], [Down arrow] 


Navigates forwards and backwards through links. 


[Pg Up], [Pg Dn] Scroll one page forward/back. 
[Right Arrow] Follow a link. 
[Left Arrow] Go one step back in history. 


[G] Open an input line where you can enter a new address. 


[Shift-G] 


Opens the same address input line but displays the last address you 
visited, allowing you to modify the address. 


[D] Stores a local copy of the document on your computer. 


[Shift-7] (/) 


Forwards search in current document. 


[Shift--] (?) 


Backwards search in current document. 
IN] Go to next match. 


[Shift-N] Go back to previous match. 

[Shift-0] (=) Open information window with details on URL, size, character set, 
Web server etc. 

IN Display source code of document, pressing the key again takes you 
back to the browser view. 

[A] Add a bookmark. 

[S] Open bookmark management. 

[Ctrl-R] Reload document. 
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Table 3: w3m Keyboard Controls INFO 
[Shift-H] Calls help. [1] Lynx: http://lynx.isc.org/ 
[Q] Quits w3m after prompting to confirm. [2] Links: http:/links.sourceforge.net/ 
[Shift-Q] Quits w3m without prompting. [3] w3m: http:/w3m.sourceforge.net/ 
[Space], [B] Scroll one page forwards / backwards through the current file. [4] Mutt: http:/www.mutt.org/ 
[G], [Shift-G] Go to first / last line of document. 
[Tab] Go to next link. 
[Esc], [Tab] (or [Alt-Tab]) Go to previous link. The next time you receive an HTML- 
[Return] Follow link. formatted message, you can simply press 
[Shift-B] Go back to previous page. [V] (for view attachments) and select t 
[U] Display the URL for the current file in the bottom left-hand corner he HTML attachment by pressing the 

of the window. [Enter] key. 

[Shift-U] Open a dialog where users can enter a new URL. 
[Shift-7] (I) Forward search for a search key. 
[Shift-?] (?) Backward search for a search key. Format, Format 
IV] Toggle browser between normal and source code view. All three of the browsers discussed in 
[Esc], [A] (or [Alt-A]) Add document to your list of bookmarks. this article use the dump command line 
[Esc], [B] (or [Alt-B]) Display bookmarks. option for converting HTML pages to 
[Shift-R] Reload page. neatly formatted files in ASCII text for- 
[S] Open a history of the recently visited pages. mat. The following commands 
[Esc], [S] (or [Alt-S]) Save the file to disk. 
[0] Open dialog for personal settings. 
[E] Open Sein editor (as aa configuration dialog). itis SEM AAS SVAN NM 


lynx.html | less 


add the following entry to your ~/.mail- | Then add the path to your own mailcap tell the Lynx browser to ormat the do- 


cap file: file to the configuration file ~ /.muttre: cument and call the less pager to dis- 
play the document on the screen page 
text/html; links 4s set mailcap_path = ~/.mailcap by page. 


SELLING OUT FAST! 
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Fedora Core 3 


For more information see: 
www.linux-magazine.com/Backissues 
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